home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / readme.zoo / readme < prev    next >
Encoding:
Text File  |  1991-11-25  |  5.7 KB  |  208 lines
  1. This is my port of various gnu utilities.  They are intended for use
  2. under bash1.10, also available on atari.archive.umich.edu.  Together,
  3. these give you a rather complete Un*x environment based on gnu software.
  4. The following zoo archives are available.  These also include some
  5. non-GNU public domain software.
  6.  
  7.        executables    source    manual_pages
  8.       -------------------------------------
  9.         file31b       file31s     manpages
  10.         shell13b      shell13s    
  11.         text11b       text11s     
  12.         misc1b        misc1s      
  13.                                   README
  14.         mint
  15.  
  16. What do you need to set yourself up?  First, you need bash.  I
  17. keep everything on disk D:  under a directory called gnu.  The
  18. following is my directory setup:
  19.  
  20. gnu
  21.    bin
  22.    gxxinc
  23.    include
  24.    lib
  25.    man
  26. etc
  27.  
  28. Until you have a good feel for how everything works together, I
  29. recommend you use it.  Put bash.ttp in \gnu\bin.  Now you need to know
  30. about UNIXMODE.  The gnu libraries emulate unix style filenames and
  31. symbolic links.  If a filename consists of all digits and lowercase
  32. letters and has no more than 8 characters plus 3 character extender,
  33. it maps directly to a TOS filename.  Otherwise, a name TOS file is
  34. made up from the real name and an entry in a file called ".dir" is
  35. maintained to describe the mapping.  Symbolic links are also recorded
  36. in the same filey.  This feature is controlled via the UNIXMODE
  37. environment variable.  It is a string of characters for customizing
  38. UNIXMODE operation.  By default, bash will set it to "/.,rCLAHdb".
  39. These characters mean:
  40.  
  41. "/"    permit "/" as well as "\" to separate path elements
  42. ".,"   map extra periods to "," when deriving TOS names.
  43. "rC"   make root file system be drive C.
  44. "L"    permit symbolic links
  45. "A"    permit unix style filenames
  46. "H"    hide the .dir file from directory searches
  47. "d"    provide psuedo device directory
  48.            /dev/X is file system x:
  49.            /dev/console is CON:
  50.            /dev/tty1    is AUX:
  51.            /dev/lp      is PRN:
  52. "b"    open files in binary mode
  53.  
  54. The only ones you would every probably want to modify are "rC" to
  55. select another file system as root and "d" if you use MiNT.  MiNT
  56. users will probably want to use the string "/.,rULAHb", unless they
  57. are using minix file systems instead, in which case "/rUbcu" is
  58. probably what you want.  (The "cu" means case is significant and name
  59. length is unlimited).  Note that this must be setup before you run
  60. bash.  I've included in the README archive a program for setting
  61. desktop's environment variables that I stole from a TeX distribution.
  62. Note that programs compiled with the MiNT libraries do not know about
  63. UNIXMODE.  hence you must use command lines like
  64.    $ bg -o d:\\nohup\\output  command string
  65. when using MiNT utilities,  or use my UNIXMODE aware versions.
  66.  
  67. You will want to put all the binary archives (*b.zoo) in /gnu/bin
  68. and than manual pages ones (*m.zoo) in /gnu/man.  Now, what all
  69. do you get?  The following lists the commands from each utility
  70. package with notes on some of them.  Some individual tools are not
  71. ported since their functionality is not available under TOS or
  72. UNIXMODE.
  73.  
  74.  
  75. ***** README ******
  76. copying -- the GNU communist manifesto
  77. copying.lib -- the GNU communist manifesto for libraries
  78. env.inf -- see setenv.prg
  79. passwd -- sample /etc/passwd (Yes it is usefull.  Files pretend to be
  80.           owned by user 1.  Make an entry for yourself to make ls -l
  81.           and some other commands look nice.
  82. profile -- sample /etc/profile.  When you start up bash, give it the  -login
  83.            parameter.
  84. readme -- this file
  85. setenv.prg -- program for setting environment variables from desktop.
  86.               I've never used it.  I don't have source.  Don't tell
  87.               me about problems with it.  Uses env.inf.
  88. termcap --/etc/termcap used by emacs and some other programs.
  89.  
  90.  
  91. ****** SHELL UTILITIES 1.3 *******
  92.  
  93. basename
  94. date
  95. dirname
  96. env
  97. expr
  98. groups -- not ported
  99. id
  100. logname
  101. nice -- not ported.  See MiNT utilities
  102. nohup -- not ported.  See "bg" in MiNT utilities
  103. pathchk -- /dev is not fully emulated as a directory
  104. printenv
  105. printf
  106. sleep
  107. stty -- not ported.  See MiNT utilities
  108. tee
  109. test -- testing /dev/X always succeeds, even if filesystem not mounted.
  110. tty -- not ported
  111. whoami
  112. uname -- not ported
  113. yes
  114.  
  115. ***** FILE UTILITIES 3.1 ******
  116.  
  117. chgrp -- not ported.
  118. chmod -- can only modify the user write bit.
  119. cp
  120. dd
  121. df -- doesn't recognize /dev/A or /dev/B
  122. dir
  123. du
  124. install
  125. ln
  126. ls
  127. mkdir
  128. mkfifo -- not ported.
  129. mknod -- not ported.
  130. mv
  131. rm
  132. rmdir
  133. touch
  134. vdir
  135.  
  136. ***** TEXT UTILITIES 1.1 *****
  137.  
  138. cat
  139. cmp
  140. comm
  141. csplit
  142. cut
  143. expand
  144. fold
  145. head
  146. join
  147. paste
  148. pr
  149. sort
  150. split
  151. sum
  152. tac
  153. tail
  154. unexpand
  155. uniq
  156. wc
  157.  
  158. ***** MISC UTILITIES 1 *****
  159.  
  160. Several of these were already ported, but I wanted them built with
  161. the latest and greatest libraries since a number of fixes have been
  162. done,  so I did a new quick and dirty port.  Include also are some
  163. non-GNU software.  These will receive lower priority as far as
  164. sustaining goes.  Send me bug reports anyway.
  165.  
  166. combine  -- best file comparer in the world.  Humans can actually
  167. combine2 --    read the output of these and they are great for three
  168.          --    way compares when doing merges.
  169. diff
  170. diff3 -- not ported.
  171. egrep
  172. find
  173. fgrep
  174. grep
  175. locate -- not ported
  176. patch
  177. sed
  178. xargs
  179. which -- I wrote this one a long time ago.
  180.  
  181.  
  182. mkid -- software package for maintaining database of words from text
  183. lid --  or software soruces.  We live and swear by it at Harris.
  184. idx
  185. fid
  186. gid -- symbolic link to lid.ttp
  187. aid -- ditto
  188. eid -- ditto
  189. pid -- ditto
  190. iid
  191.  
  192. ###################
  193.  
  194. mint
  195.  
  196. unixmode aware version of some MiNT utilities:
  197.  
  198. bg
  199. limit
  200. lpd
  201. lpr
  202. nice
  203. pipe
  204.  
  205. Let me know of any bugs you find.  Fixes to them are also appreciated.
  206. These need to be built with at least patchlevel 74 libraries (Which
  207. are not yet (November 10, 1991) available for general consumption).
  208.